Skip to content

[Feat/#87] OAuth 로그인 API 추가 - #92

Merged
tnals0924 merged 6 commits into
mainfrom
feat/#87-oauth-login-api
Oct 2, 2026
Merged

[Feat/#87] OAuth 로그인 API 추가#92
tnals0924 merged 6 commits into
mainfrom
feat/#87-oauth-login-api

Conversation

@tnals0924

@tnals0924 tnals0924 commented Sep 30, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

#️⃣연관된 이슈

🎯 해결하려는 문제가 무엇인가요?

POST /v1/auth/login/{provider} 로그인 API를 추가합니다. 앱·웹이 { code, codeVerifier, redirectUri }를 보내면 서비스 JWT와 약관 동의 필요 여부를 내려줍니다.

{ "accessToken": "…", "termsAgreementRequired": true }

❓ 왜 해결해야 하나요?

지금까지 PR로 만든 auth 도메인·member·KConnect 구현체를 하나의 로그인 흐름으로 조립해야 실제로 로그인할 수 있습니다.

⭐ 어떻게 해결했나요?

  • AppAuthController·AppAuthApi (app-api): 경로는 /v1/app/** 밖인 /v1/auth/login/{provider}. 학생 앱과 운영진 콘솔이 같이 쓰고, 접근 범위는 토큰의 role로 나뉩니다. PublicEndpoints.AUTH로 permitAll·Swagger 공개 표기를 함께 맞췄습니다.
  • 요청 검증: 세 필드 @NotBlank, codeVerifier는 PKCE 규격(43~128자, A-Z a-z 0-9 - . _ ~)
  • OAuthLoginUseCase: authenticate → 연결된 계정으로 회원 찾기 → 있으면 프로필 갱신, 없으면 학번 기준 가입·갱신 후 계정 연결 → 토큰 발급 → 약관 동의 여부
  • 트랜잭션: 전체를 한 트랜잭션으로 묶지 않습니다. 묶으면 provider를 호출하는 동안(최대 8초) DB 커넥션을 잡게 됩니다. 가입 후 연결이 실패해도 다음 로그인에서 학번으로 찾아 다시 연결합니다.
  • AuthTokenIssuer (gateway:auth의 security 최상위 패키지): JwtProvider는 Modulith가 내부로 보는 security.jwt에 있어 api가 직접 부를 수 없어 파사드를 뒀습니다. ADMIN 회원에게는 {ADMIN, STUDENT}를 주고(운영진도 학생 앱 사용), 학생회 부서는 ADMIN에게만 싣습니다.
  • config-and-auth.md의 공개 경로 예시를 실제 경로로 갱신

🧩 이 PR의 한계 & 트레이드오프

  • Refresh Token·약관 동의 API는 없습니다(별도 작업).
  • 같은 사용자가 거의 동시에 첫 로그인을 두 번 하면(더블 탭 등) 유니크 위반으로 한쪽이 500이 됩니다. 다시 시도하면 정상 로그인됩니다.

⛓️ 기존 기능에 미치는 영향

  • 새 공개 경로 /v1/auth/login/*
  • app-api가 core:domain:auth·core:domain:member에 의존합니다.
  • 기존 JwtAuthFilter는 공개 경로라도 만료된 Authorization 헤더가 붙으면 401을 냅니다. 앱·웹은 로그인 요청에 토큰 헤더를 붙이지 않아야 합니다.

🔀 Edge Case & 실패 시나리오

상황 응답
요청 값 누락·PKCE 형식 위반 400 INVALID_INPUT
지원하지 않는 provider 400 UNSUPPORTED_OAUTH_PROVIDER
redirect URI가 허용 목록에 없음 400 REDIRECT_URI_NOT_ALLOWED
code 만료·재사용·verifier 불일치 401 INVALID_AUTHORIZATION_CODE
SW·AI 전공이 아님 403 DEPARTMENT_NOT_ALLOWED
KConnect 응답 없음·5xx 502 OAUTH_PROVIDER_UNAVAILABLE
KConnect 설정 오류(invalid_client, 설정 누락) 500

📋 검토한 대안과 선택 이유

  • UseCase 전체에 @Transactional: provider 호출 동안 커넥션을 점유해 제외했습니다.
  • 외부 호출 뒤 구간만 TransactionTemplate: 컨벤션에 없는 새 패턴이라 보류하고, 학번 조회로 복구하는 방식을 택했습니다.
  • /v1/app/auth/...: 운영진 콘솔도 같은 로그인을 써서 공용 경로로 뒀습니다.

💬 리뷰 포인트

  • 트랜잭션 경계와 연결 실패 시 복구 흐름
  • 토큰 role 부여 규칙(ADMIN → ADMIN + STUDENT)
  • 공개 경로 범위(/v1/auth/login/*)

@tnals0924 tnals0924 self-assigned this Sep 30, 2026
@coderabbitai

coderabbitai Bot commented Sep 30, 2026 •
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 49 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Repository: billilge/stream-server/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 99983c17-1710-43ae-8a28-ecf971d0fb01

📥 Commits

Reviewing files that changed from the base of the PR and between c3cd1f0 and 97b5dbb.

📒 Files selected for processing (16)
  • .env.example
  • api/app-api/build.gradle.kts
  • api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/AppAuthApi.java
  • api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/AppAuthController.java
  • api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/request/OAuthLoginRequest.java
  • api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/response/OAuthLoginResponse.java
  • api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/usecase/OAuthLoginUseCase.java
  • docs/conventions/config-and-auth.md
  • gateway/auth/src/main/java/kr/ac/kookmin/stream/security/AuthTokenIssuer.java
  • gateway/auth/src/main/java/kr/ac/kookmin/stream/security/PublicEndpoints.java
  • infrastructure/client/build.gradle.kts
  • infrastructure/client/src/main/java/kr/ac/kookmin/stream/client/oauth/kconnect/KConnectClientConfig.java
  • infrastructure/client/src/main/java/kr/ac/kookmin/stream/client/oauth/kconnect/KConnectOAuthClient.java
  • infrastructure/client/src/main/java/kr/ac/kookmin/stream/client/oauth/kconnect/KConnectProperties.java
  • infrastructure/client/src/main/java/kr/ac/kookmin/stream/client/oauth/kconnect/KConnectTokenResponse.java
  • infrastructure/client/src/main/resources/application-infrastructure-client.yml
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@tnals0924 tnals0924 mentioned this pull request Sep 30, 2026
Merged
jjunh33
jjunh33 approved these changes Oct 2, 2026
View reviewed changes
Comment thread gateway/auth/src/main/java/kr/ac/kookmin/stream/security/AuthTokenIssuer.java
private final JwtProvider jwtProvider;

public String issue(Long memberId, Role role, CouncilDepartment councilDepartment) {
return jwtProvider.generateAccessToken(memberId, rolesOf(role), councilDepartmentsOf(role, councilDepartment));

@jjunh33 jjunh33 Oct 2, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

app-api단에서 JwtProvider를 직접 호출하면 모듈 내부를 참조하여 Modulith 원칙에 어긋나고 검증에 걸리기 때문에, 외부에 노출할 수 있는 AuthTokenIssuer 파사드를 따로 두어 구현한 점 이해했습니다!

leegain1
leegain1 reviewed Oct 2, 2026
View reviewed changes
Comment thread api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/usecase/OAuthLoginUseCase.java

@leegain1 leegain1 Oct 2, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

provider를 호출하는 동안 DB 커넥션을 잡지 않으려고 UseCase 전체를 트랜잭션으로 묶지 않고, 연결이 실패하면 다음 로그인 때 학번으로 다시 연결되게 하신 부분 이해했습니다!

leegain1
leegain1 reviewed Oct 2, 2026
View reviewed changes
Comment thread api/app-api/src/main/java/kr/ac/kookmin/stream/api/app/core/auth/usecase/OAuthLoginUseCase.java

String accessToken = authTokenIssuer.issue(member.getId(), member.getRole(), member.getCouncilDepartment());
// 회원을 이번에 만들었는지가 아니라 동의 기록으로 판단한다. 가입 후 동의하지 않고 이탈한 회원도 다시 약관 화면을 본다
boolean termsAgreementRequired = !memberTermService.hasAgreedRequiredTerms(member.getId());

@leegain1 leegain1 Oct 2, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

지금 보면 약관 동의 전에도 토큰이 정상 발급돼서, 앱 화면을 거치지 않고 api를 직접 호출하면 동의 없이도 다른 기능을 쓸 수 있을 것 같더라고요.
약관 동의 API를 붙일 때 미동의 회원의 api 접근도 같이 막을 계획이신지 궁금합니다!!

@tnals0924
tnals0924 changed the base branch from feat/#86-kconnect-client to main October 2, 2026 09:40
@tnals0924
tnals0924 merged commit 528429f into main Oct 2, 2026
1 check passed
@tnals0924
tnals0924 deleted the feat/#87-oauth-login-api branch October 2, 2026 09:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@leegain1 leegain1 leegain1 left review comments
@jjunh33 jjunh33 jjunh33 approved these changes
@sangrae2325 sangrae2325 sangrae2325 approved these changes

Assignees

@tnals0924 tnals0924

Labels

✨ FEAT

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

OAuth 로그인 API 추가

4 participants

@tnals0924 @jjunh33 @sangrae2325 @leegain1